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Preface 


This manual describes the features and functions of the System 
Documentor component of the ControlView system. The 
System Documentor is installed automatically as part of the 
ControlView Core. 


This manual supplements the information in the ControlView 
Core User's Manual. It contains information on: 


. configuring your system to produce reports 
. producing and using reports on your application 


The System Documentor provides hard copy reports about how 
you have configured your ControlView system. Reports can be 
generated through the menus or the command line. 


Audience 


Read this manual if you intend to use the System Documentor 
to produce reports about your system's configuration. The 
System Documentor is a part of ControlView; therefore, you 
should be familiar with ControlView and have the ControlView 
Core User's Manual available for reference. 


Conventions Used in This Manual 


This manual follows the print conventions outlined in the 
ControlView Core User's Manual. 


Related Publications 


A complete list of related publications can be found in the 
ControlView Core User's Manual. 
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Why Use the System 
Documentor? 


What Can | Document? 


How Can | Produce 
System Documentation? 


Chapter 


Introduction 


With ControlView's System Documentor, you can examine 
your system's configuration without scrolling through dozens 
or hundreds of configuration screens. As a systems integrator, 
you can show on paper exactly how you have set up a client's 
system. As a client, you have an accurate and easy-to-read 
method of verifying that the system is configured as specified. 
For a systems maintenance officer, the Documentor supplies a 
constant and reliable reference for tracking down 
configuration-related problems or making necessary changes. 
As à new systems manager, you can get a complete hard copy 
of all the system's details, including any modifications since it 
was first installed. And, of course, the Documentor provides a 
means of reconstructing a system that has not been properly 
backed up, or of duplicating all or part of a system's 
configuration for a new plant or process. 


Using the System Documentor, you can produce up-to-the- 
minute comprehensive reports about each of the following 
areas in ControlView: 


‘ Hardware configuration (devices, highways, printers, 
nodes) 


۰ Databases (scan classes, tags, derived tags, alarms) 
Activity and data logging (including alarms and trending) 
* Event detection 

s Mouse GRAFIX displays 

i Security 


° ControlView Core and option revision numbers 


Reports are easy to configure and produce, with simple fill-in- 
the-blanks screens and ready-to-use default parameters. All the 
reports are listed under the Document menu item in the Setup 
Menu, and can be run with a minimum of preparation. For 
those who prefer the command line, all menu items are also 
available as commands (see Appendix A). 
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Introduction 
How Can | Produce System Documentation? 


Reports are produced as ASCII text files. They can be printed 
and then discarded, or saved in whatever directories you 
specify. Default file names and paths are supplied by the 
system, but can be changed either on a system-wide basis or 
temporarily, one at a time. 


Available Reports 


Chapter 


Using the System Documentor 


This chapter explains how to produce, save, view and print 
reports about your ControlView system's configuration. 


From the Setup Menu, choose Document. 


Figure 2-1 
The Document Menu 


Configure System Documentor 


Device Configuration 

Network Printer Configuration 
Node Configuration 

Scan Classes 

Databases 


Derived Tag Files 

Event Detector Files 

Activity Log Configuration 
Data Logger Configuration 
Alarm Severity Configuration 


Mouse GRAFIX Displays 
Trend Displays 


Command Security 
User Accounts 


Revision Information 
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For this release, the following reports are available: 


Device Configuration: a report of the entries in the 
Device Configuration screen, including devices such as a 
mouse, serial printers, Control Panel keyboards, parallel 
or network printers, data highways and KT Adaptors 


Network Printer Configuration: a report on all network 
printers as defined in the Novell Printer Configuration 
window and its associated screens, including server 
details, banner text and name, and capture data 


Node Configuration: a report of the entries in the Node 
Configuration screen; the names, types, addresses, status, 
time-out period and number of retries for all 
programmable controllers configured to communicate 
with ControlView over the data highway(s) 
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Available Reports 


Scan Classes: a report of the entries in the Scan Class 
Configuration window, defining each scan class's 
foreground and background periods and the device 
classes associated with them 


Databases: a report on the configuration of the database 
specified; tag names, types and descriptions, analog, 
digital and group tag lists, and details of addresses, scale 
and offset, class and security access. If the Alarming 
option is installed, includes details of digital and analog 
alarm configuration for the specified database, as well as 
Alarm Identification commands and file/printer messages 


Derived Tag Files: if the Derived Tag option is installed, 
a report on the derived tag list and descriptions in the 
Derived Tag File Editor screen for the Derived Tag file 
specified 


Event Detector Files: if the Event Detector option is 
installed, a report on the event list and descriptions in the 
Event Editor screen for the Event Detector file specified 


Activity Log Configuration: a report on the entries in 
the Activity Logging Configuration screen; includes 
activity type, label, and whether the event is logged to 
disk, printer or both 


Data Logger Configuration: if the Data Logger option is 
installed, a report on the configuration of the Data Logger 
model specified, including model name, description, 
sample rate and file information 


Alarm Severity Configuration: if the Alarming option is 
installed, a report on the configuration of the Alarm 
Severity Table, showing the attributes for each of the 
eight alarm severities, including alarm color and logging 
destinations 


Mouse GRAFIX Displays: if the Mouse GRAFIX Editor 
option is installed, a report on the configuration of 
graphic control objects in the specified display, and the 
key commands associated with them; if a PDF (Pixel 
Dump File) has been generated in the Mouse GRAFIX 
Editor for the specified display, and if a graphics printer 
has been correctly configured, the report will include a 
picture of the display 


Trend Displays: if the Trending option is installed, a 
report on the Trend named 


Available Reports 


Configuring the Report 
Settings 
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° Command Security: a report on the commands, macros 
and displays in the Secure Object Table Editor display, 
listing each object's name, the access code it is assigned 
to and comments 


* User Accounts: a report on the entries in the Security- 
User Account Browser display, listing each user's name, 
access code privileges and logon macro 


. Revision Information: a report listing all installed 
options, with their revision numbers and dates 


To redefine the default report settings, choose Configure 
System Documentor. 


Figure 2-2 
System Documentor Configuration Window 


Output File Path: 
Text Printer: Graphics Printer: 
Save Report: Print Report: 


Accept <+>) Cancel<Esc> 
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Any changes you make in this window will become the new 
defaults once they are saved, and will appear in all subsequent 
System Documentor report windows. The settings can be 
changed temporarily in each report window any time you 
produce a System Documentor report. 


The fields are: 
. Output File Path 


To use a directory other than the default NACCESSNDOC 
for your report files, enter the correct path here. 


۰ Text Printer 


Choose a text printer, one of Printer1 through Printer4 as 
previously defined in the Device Configuration screen. 


Graphics Printer 


Choose a graphics printer, one of Printer1 through 
Printer4 as previously defined in the Device 
Configuration screen. This will probably, but not 
necessarily, be a different printer than the text printer 
chosen above. 


Note: For this release, only the Mouse GRAFIX Report 
option can print graphics. 
2-3 
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Configuring the Report Settings 


° Save Report 
To save your report files to disk, choose Yes. 
. Print Report 
To send your reports to the printer, choose Yes. 


If you choose No for both of these settings, Control View will 
show an error message. 


The Filename Field 


Choose Derived Tag Files. The Derived Tag Report window 
opens. This window (as well as the windows for Data Logger 
Configuration, Event Detector Files, and Trend Display 
reports), has an additional field in which you must specify a 
filename. Otherwise, the fields are the same. 


Figure 2-3 
Derived Tag Report Window 


Derived Tag File: (— 1 1 1] 
Output File Path : 


Printer : Print Report : Yes 
Save Report : Report Filename : 


Accept <+>) Cancel<Esc> 
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Additional Fields in the Database Report Window 


For a third example, choose Databases. The Database Report 
window opens. 


Figure 2-4 
Database Report Window 


Database: [| Number of columns : î 
Group List:[ |] Analog List :[__] DigitalList:[ ^] Alarm List:[_ |] 
Output File Path : 


Printer : ا‎ Print Report : fare] 
Save Report: [ |] Report Filename: [||| j] 


Accept <+>) Cancel<Esc>) 
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Configuring the Report Settings 


Producing a Report 
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This window is unique in having several additional fields: 
. Database 


Type in the name of the database that you want the report 
on. 


M Number of columns 
Choose one of 80 or 132 columns per line. 
° Group List 


If you want the database report to include a list of group 
tags, choose Yes. 


. Analog List 


If you want the database report to include a list of analog 
tags, choose Yes. 


$ Digital List 


If you want the database report to include a list of digital 
tags, choose Yes. 


۰ Alarm List 


If you want the database report to include a list of tags 
with alarms, choose Yes. 


All reports are produced in the same way. For example, choose 
Device Configuration. The Device Configuration Report 
window opens. The fields contain the defaults from the System 
Documentor Configuration window, and a default filename. 
You can change any or all of these for this report only. 

Figure 2-5 

Device Configuration Report Window 


SSS 


Output File Path : CESSNDOC 


Printer : Print Report: [Yea] 
Save Report : [Yes ] Report Filename : 


Accept <+>) Cancel<Esc>) 
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To produce the report, accept the entries on the screen with the 
Accept button or the + key. The system will create the report as 
an ASCII text file, printing and/or saving it to disk, depending 
on your choices. 


Here is a sample of a Device Configuration Report based on a 
possible Control View configuration. 
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Producing a Report 


Figure 2-6 
Sample Device Configuration Report 


ControlView Device Configuration Report 
05-08-91 2:27:45 pm 
Device Configuration 


Serial Port Device Baud Rate Data Bits Stop Bits 


IBMCOMI MOUSE 1 
IBMCOM2 HIGHWAYI 1 
MXCOM3 PANEL1 1 
MXCOM4 PRINTER2 2 


Printer Port Device 


LPT1 PRINTER3 

LPT2 Use PS/2 Auxiliary Mouse Port No 
NetLPT1 PRINTER2 

NetLPT2 

NetLPT3 


Printer Configuration 


Printer Printer Initialization Code 
Device Type (Kilobytes) 


PRINTER1 B+W 125 2715 
PRINTER2 JX80 100 

PRINTER3 HP-PCL 100 

PRINTER4 B+W 


Spool Path 
\access\tmp\ 


No. of messages 


HIGHWAY1 3 
HIGHWAY2 3 


Device Address Terminating Resistor 


HIGHWAY2 17 RESET 


Page 2 
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O Producing a Report 


Note: The recent addition of the"Base Address" field to the KT 
Configuration screen is not currently reflected in the System 
Documentor Device Report. 


Here is a sample report using the SALAD database from the 
Sample Applications: 


Figure 2-7 
Sample Database Report 


ControlView Database Report 


Database: salad Date: 06-04-91 11:42:31 am 
Tag Name Tag Type Tag Description 
MIXER GROUP 
MIXER.LEVEL ANALOG Salad dressing mixer tank level 
MIXER.MOTOR DIGITAL Mixer motor control 
MIXER.OILIN ANALOG Salad mixer oil flow in 
MIXER.OUTFLOW ANALOG Sald mixer total flowout 

4. MIXER.RATIO ANALOG Mixer oil to vinegar ration 


MIXER.VALVE DIGITAL Salad mixer tank valve 


MIXER.VININ ANALOG Salad mixer vinegar flow in 
OIL GROUP 

OIL.LEVEL ANALOG Bulk salad oil level 

OIL. VALVE DIGITAL Bulk oil tank valve 

VIN GROUP 

VIN.LEVEL ANALOG Bulk vinegar tank level 
VIN.VALVE DIGITAL Bulk vinegar tank valve 
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Figure 2-7 
Sample Database Report (cont'd) 


ControlView Database Report Analog Tag List 


Database: salad Date: 05-03-91 11:42:31 am 

Tag Name Node:: Address & Tag Scale & 
Offset Offset 

MIXER.LEVEL 

MIXER.OILIN 

MIXER.OUTFLOW 

MIXER.RATIO 

MIXER.VININ 


OIL-LEVEL 


VIN.LEVEL 


ControlView Database Report Digital Tag List 


Database: salad Date: 05-03-91 11:42:31 am 


Tag Name Node::Address On Label & Off Class 
& Offset Label 


MIXER.MOTOR motor on 
motor off 


MIXER.VALVE open 
close 


OIL.VALVE open 


VIN.VALVE 


Producing a Report 


Class & 
Access 


Access 


Viewing or Printing a Report 


Viewing or Printing a 
Report 
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To view a report that has been saved to disk, choose List File 
under Tools. 


Figure 2-8 
List File Window 


Load | Start/Stop | View | Tags | Security ETN setup | Exit 


List File 


List which file? 


\access\doc\cvdb.rpt 
Accept <+>) Cancel<Esc>) 
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Type in and accept the path and filename, and the file will 
appear in the List/Print window. 


To print a report file, choose Print File and follow the same 
steps. 
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System Documentor Commands 


ACCOUNTRPT 


Opens the Security Account Report window. From this window 
you can produce an ASCII file report on the configuration of all 
security accounts currently in use by ControlView. 


ACTIVITYRPT 


Opens the Activity Log Report window. From this window you 
can produce an ASCII file report on the configuration of the 
Activity Log currently in use by ControlView. 


ALARMRPT 


Opens the Alarm Configuration Report window. From this 
window you can produce an ASCII file report on the 
configuration of alarm severity. 


CLASSRPT 


Opens the Scan Class Configuration Report window. From this 
window you can produce an ASCII file report on the 
configuration of scan classes for the database currently in use 
by ControlView. 


DATALOGRPT [model] 


Opens the Data Logger Report window. From this window you 
can produce an ASCII file report on the configuration of the 
Data Logger model named. 


[model] is the name of a Data Logger model. If not 
specified, the model name will have to be 
entered in the appropriate field in the window. 
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DBRPT 


DERIVEDRPT 


DEVICERPT 


DOCUMENTOR 


EVENTRPT 
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DBRPT 


DBRPT [database] 


Opens the Database Report window. From this window you 
can produce an ASCII file report on the configuration of a 
database. 


[database] is the name of a database. If not specified, the 
database name will have to be entered in the 
appropriate field in the window. 


DERIVEDRPT [filename] 


Opens the Derived Tag Report window. From this window you 
can produce an ASCII file report on the configuration of 
derived tags in the derived tag file named. 


[filename] is the name of a derived tags file. If not 
specified, the filename will have to be entered in 
the appropriate field in the window. 


DEVICERPT 


Opens the Device Configuration Report window. From this 
window you can produce an ASCII file report on the 
configuration of the Device Configuration currently in use by 
ControlView. 


DOCUMENTOR 


Opens the System Documentor Configuration window where 
default parameters for System Documentor reports are defined. 


EVENTRPT [filename] 


Opens the Event Detector Report window. From this window 
you can produce an ASCII file report on an Event Detector file. 


[filename] is the name of an Event Detector file. If not 
specified, the filename will have to be entered in 
the appropriate field in the window. 


GRAFIXRPT 


GRAFIXRPT 


NODERPT 


NOVRPT 


REVISIONRPT 


SECURITYRPT 


TRENDRPT 
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GRAFIXRPT [filename] 


Opens the Mouse GRAFIX Report window. From this window 
you can produce an ASCII file report on the configuration of 
the graphic control objects and key definitions for a GRAFIX 
display. 


[filename] is the name of a Mouse GRAFIX display file. If 
not specified, the filename will have to be 
entered in the appropriate field in the window. 


NODERPT 


Opens the Node Configuration Report window. From this 
window you can produce an ASCII file report of all nodes 
(programmable controllers) currently configured to 
communicate with ControlView via the communication 
network (data highway). 


NOVRPT 


Opens the Novell Printer Report window. From this window 
you can produce an ASCII file report detailing the Novell 
printer configuration parameters for network printers NetLPT1, 
NetLPT2 and NetLPT3 as defined in the Novell Printer 
Configuration and Novell Printer Capture Data screens. 


REVISIONRPT 


Opens the Revision Report window. From this window you can 
produce an ASCII file report on the revision number of all 
options currently installed on ControlView. 


SECURITYRPT 


Opens the Security Command Report window. From this 
window you can produce an ASCII file report on all object 
security configured on ControlView. 


TRENDRPT [filename] 


Opens the Trend Report window. From this window you can 
produce an ASCII file report on a trend display configuration. 


[filename] is the name of a trend display. If not specified, 
the filename will have to be entered in the 
appropriate field in the window. 
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